DCIM API 文档机房

机房添加

本文说明智简魔方 DCIM 系统中“机房添加”相关的接口或函数信息，供开发人员在集成、调用和排查问题时参考。

概述

智简魔方 DCIM 数据中心服务器管理系统中，「添加机房」所需的参数。

URL

/index.php?m=api&a=houseAdd

请求参数

字段名	变量名	必填	类型	描述
机房名称	`name`	是	`string`	机房名称
机房别名	`alias`	否	`string`	机房别名
联络人	`liaisons`	否	`string`	机房联络人
电话	`mobile`	否	`string`	机房联系人电话
邮箱	`email`	否	`string`	机房联系人邮箱
备注	`remarks`	否	`string`	备注信息
被控地址	`ipmi_url`	是	`string`	IPMI 被控 URL 地址，远程控制需要
被控用户名	`ipmi_user`	是	`string`	IPMI 被控用户名，远程控制需要，用以验证身份信息
被控 KEY	`ipmi_pass`	是	`string`	IPMI 被控密钥，远程控制需要，用以验证身份信息
DNS1	`dns1`	否	`string`	dns1
DNS2	`dns2`	否	`string`	dns2
临时 VLAN	`vlan`	否	`int`	临时 VLAN
被控 root 密码	`root_pass`	是	`string`	被控 root 密码
被控 SSH 端口号	`ssh_port`	是	`int`	被控 SSH 端口号
IPMI 代理 IP 地址	`vnc_url`	否	`string`	IPMI 代理 IP 地址
IPMI 代理授权码	`vnc_license`	否	`int`	IPMI 代理授权码

返回参数

字段名	变量名	类型	描述
状态	`status`	`string`	success 成功 error 失败
机房 ID	`id`	`int`	机房 ID
信息	`msg`	`string`	提示信息

机房列表

用于在智简魔方 DCIM 中分页查询机房信息。接口采用 HTTPS POST，需 API 用户名和密码且来源 IP 匹配账号配置；搜索、分页、排序和是否展开机柜均为可选，返回机房列表、总数、设备与机柜数量，以及连接和自动化配置状态。

机房修改

用于在智简魔方 DCIM 中修改指定机房。接口采用 HTTPS POST，调用方须提交 API 用户名和密码，且来源 IP 与账号配置一致；需提供机房名称（name）和机房 ID（id），处理后返回处理状态和提示信息。

本页目录

概述 URL 请求参数返回参数